home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Topik / Topik - Disk 36 - Archivers (19xx)(Topik Public Domain)(PD)[WB].zip / Topik - Disk 36 - Archivers (19xx)(Topik Public Domain)(PD)[WB].adf / lharc / lharc.doc < prev    next >
Text File  |  1990-10-07  |  28KB  |  677 lines

  1.  
  2. *** TOPIK Note : LHArc is accessible from the CLI in this directory.
  3.  
  4. ________________________________________________________________________
  5. ------------------------------------------------------------------------
  6.  
  7.  
  8.                         LHARC        vers. 1.20
  9.  
  10.                         for the Commodore AMIGA
  11.          Compatible with version 1.13 of Lharc for MSDOS systems
  12.  
  13.                   by Paolo Zibetti   (FidoNet 2:331/101.6)
  14.                   (assembler routines by  Paolo Toccaceli)
  15.  
  16.  
  17. ------------------------------------------------------------------------
  18.  IMPORTANT NOTICE:  This program is copyrighted by Paolo Zibetti, but can
  19.  be freely distributed, providing that the following rules are respected.
  20.  - No change is made to the program nor to the accompaning documentation
  21.  - The package is always distributed in its complete form consisting of
  22.    3 files: "Lharc", "Lharc.doc" and "Changes".
  23.  - Every form of distribution is allowed and encouraged, but no fee can
  24.    be charged for this program exept for, possibly, the cost of magnetic
  25.    media and/or disk duplication and shipping.
  26.  - Inclusion in PD software libraries such as Fish Disks is allowed,
  27.    provided the fees charged for theese disks are comparable with those
  28.    charged by Fred Fish.
  29.  - The program cannot be distributed in any commercial product without the
  30.    written consent of the author.
  31.  By copying, distributing and/or using the program you indicate your
  32.  acceptance of the above rules.
  33.  Also remember that this program is supplied 'as is': the entire risk as
  34.  to the quality of the program is to the user. In no event will the author
  35.  be liable for direct or indirect damage or loss resulting from the use
  36.  of this program.
  37. ------------------------------------------------------------------------
  38.  
  39. ________________________________________________________________________
  40. ------------------------------------------------------------------------
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  --- Introduction ---
  52.  
  53. Lharc is an archive program such as Arc and Zoo. It can store several
  54. files in one archive in a compressed form which is generally more
  55. efficent than that used by Arc and Zoo.  It also supplies all of the
  56. archive handling capabilities that an archive program should have.
  57. In particular it is able to store an entire directory tree
  58. with one single command. This enables you, for example, to store an
  59. entire floppy-disk with a single command creating an archive which is
  60. usually shorter than those prodeced by Warp or even LhWarp (see the -r
  61. switch).
  62. Another important feature of Lharc is its ability to preserve the file
  63. attributes (see the -a switch) and filenotes (i.e. the comments that
  64. AmigaODS can associate to each file).
  65. Its only weakness is compression speed: Zoo 2.0, for example, is
  66. faster, but if compression efficency is more important for you than
  67. compression time you'll surely appreciate this progam. (anyway
  68. decompression is much faster than compression)
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  --- Before starting ---
  77.  
  78. Lharc is a 'pure' program, i.e. you can make it resident via the
  79. 'resident' Amigados command just like any other command found in the
  80. c: directory. Keeping Lharc resident will greatly facilitate users
  81. who make an heavy use of Lharc (especially those who don't have an
  82. hard disk).
  83. If you have just received Lharc, beware that some copy programs and
  84. some archivers (including the zoo archiver which is used for
  85. distribution of Lharc) don't preserve file attributes, so the 'p'
  86. flag may not be set for the Lharc executable and Amigados won't
  87. understand that Lharc is a pure program. If so, just type the
  88. following line at the CLI prompt:
  89.  
  90.  protect Lharc p add
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  --- How to use ---
  99.  
  100. Lharc is run from CLI with the following command line:
  101.  
  102.   Lharc [<switches>] <Command> <Archive> [<dest path>] [<file patterns>]
  103.  
  104. items in square brackets are optional.
  105.  
  106.  
  107.  
  108.  
  109. <Command> can be any of the following (case is not significant):
  110.  
  111.  
  112.   e,x  extract files from archive
  113.        Extracts files from archives. If you specify some file names
  114.        or patterns only those files satisfying the patterns are
  115.        extracted, otherwise all the files in the archive are
  116.        extracted.
  117.        While extracting files, Lharc checks if a file by the same
  118.        name already exsists in the destination directory and prompts
  119.        you before overwriting the old file with the extracted one
  120.        (unless you specified the -m switch)
  121.        By default, if the files have a path name stored in the archive, they
  122.        are extracted with their path and needed directories
  123.        are automatically created; use the -x0 switch to ignore path names.
  124.        See below under '<dest path>' for a discussion on where the
  125.        extracted files are stored.
  126.  
  127.   l    show archives contents
  128.        Displays the names of the files in an archive along with their
  129.        date, time, CRC, compression type, original lenght and
  130.        compressed lenght.
  131.        If the -x switch is specified file names are listed complete
  132.        with their path (if present in the archive), otherwise
  133.        only the name of the files is listed.
  134.        The 'l' command won't list the comments (filenotes) that may be
  135.        assiciated with a file: use the 'v' command to see them, too.
  136.  
  137.   v    Same as 'l', but default is to display full pathnames: i.e.
  138.        the 'v' command is equivalent to the 'l' command with the -x switch;
  139.        on the other hand the 'l' command is equivalent to the 'v' command
  140.        with the -x0 switch.
  141.        Moreover 'v' will also show any filenote (i.e. comment)
  142.        associated with the files; filenotes, if present,
  143.        are listed on a separate line preceded by a colon
  144.        (i.e. in the same format used by the AmigaDOS 'list' command).
  145.  
  146.   p    extract and print files to screen
  147.        same as 'e' and 'x', but extracted files are sent to stdout
  148.  
  149.   t    test archive integrity
  150.        Checks CRCs and checksums to ensure that the archive is not
  151.        corrupted. Lharc will test all the files on the archive, one
  152.        after each other, printing "OK" to the right of the file names
  153.        which are OK and "WARNING: CRC check failed" to the right of
  154.        file names that are corrupted. At the end of the test the
  155.        message "Operation successful" means that all the files tested
  156.        were OK, while the message "Operation not totally successful"
  157.        means that some files in the archive were corrupted (so you
  158.        will know of a corrupted file even if the warning message
  159.        relating to that file has scrolled away on the screen)
  160.  
  161.   a    create archives or add to existing archives
  162.        Files are stored in alphabetical order, unless you change
  163.        this with the -S switch. Note however that sorting only
  164.        applies to the files beeing added in the current session,
  165.        i.e. if you add files to an existing archive containing
  166.        other files, the new files will be stored, in alphabetical
  167.        order, AT THE END of the archive: old and new files won't be
  168.        intermixed to preserve global alphabetical order.
  169.        If you try to archive a file and a file by the same name
  170.        already exists in the archive the file will not be added
  171.        and a message will be printed on the screen to inform you.
  172.        By default only file names are stored in the archive, use the
  173.        -x switch to store file names complete with their paths.
  174.        Also, by default file attributes are not stored, use the '-a'
  175.        switch to obtain this.
  176.  
  177.   m    move files into archivs
  178.        Same as add, but deletes original files after archiving them
  179.  
  180.   d    delete files from archives
  181.        You can delete from an archive a maximum of 150 files at a time,
  182.        if you find that they are too little, please let me know!
  183.  
  184.   u    update files in archives
  185.        Same as with the 'a' command.  However, if a file already
  186.        exists in the archive, LHarc will check its time stamp and will
  187.        keep the newer one and ignore the older one.
  188.  
  189.   f    freshen files in archives
  190.        Replaces a file in the archive with the newer one only if a file
  191.        with the same name already exists in the archive.
  192.        Otherwise, no action is taken.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200. <Archive> is the name (eventually preceded by a path) of the
  201. archive you want to work on. If no extension is specified the default
  202. extension .LZH is used.
  203. With the 'l' (or 'v'), 'e' (or 'x'), 'p', 't' and 'a' commands you can
  204. work on multiple archives by using wildcards (see 'file patterns'
  205. below for a list of accepted wildcards). For example "lharc v *.LZH"
  206. will show the contents of all the archives in the current directory,
  207. while "lharc x *.LZH *.c" will extract all the C source files
  208. contained in all the archives in the current directory.
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215. [<dest path>]
  216. This parameter is significant only with the 'x' (or 'e') command and is
  217. ignored otherwise. It tells where to put the extracted files; if not
  218. specified, extracted files will go to the current directory.
  219. Please note that this paramenter must always end with '/' or ':'
  220. otherwise it will not be recognized as such and will be considered
  221. as one of the file patterns.
  222. If the path specified by <dest path> (or equivalently the path stored
  223. in the archive) does not already exist, you will be prompted if you
  224. want new directories to be automatically created (unless you specified
  225. the -m switch, in which case directories will be created without any
  226. prompt).
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233. [<file patterns>] rappresents an optional number of file names
  234. or file patterns. They indicate which files to
  235. extract/compress/list/delete, ecc.
  236. Accepted wild cards are the standard AmigaDOS '#' and '?' plus the '*'
  237. which is a synonim of '#?'. Since however the asterisk is a valid
  238. caracter in AmigaDOS file names I provided the '**' sequence as an
  239. escape.  So if you want to refer to a file name containing an asterisk
  240. just double the asterisk in the file name.
  241. Example:  '*.c' is equivalent to '#?.c' and refers to all the files
  242. ending with '.c', while 'my**file' refers to the file 'my*file'.
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249. [<switches>] rappresents an optional number of switches that are used
  250. to change the behaviour of the program.
  251. A switch is composed by  a leading '-' followed by one letter; unlike
  252. commands which are case insensitive, switches are case sensitive.
  253. An important point is that if you want to specify more than one switch,
  254. every switch must be preceded by its own dash, i.e. to activate the 'x'
  255. and 'm' switches you must enter "-x -m" and NOT "-xm".
  256. You can store your favourite switch configuration in an environment
  257. variable (see below) so that you don't have to type them every time.
  258. All the switches that don't take a parameter can be followed by a '0'
  259. which turns off the function, while the switch alone or the switch
  260. followed by a '1' turns the function on: i.e. -x means "use extended
  261. file names",  while -x0 means "don't use them". So you can override
  262. the default settings or the settings you specified in the environment
  263. variable "LHARC".
  264. Default value for every switch is off, exept for the -x switch which is
  265. by default on with the 'x' 'e' 'd' and 'v' commands and off with the
  266. other  commands.
  267.  
  268. Here is a summary of the available switches:
  269.  
  270.  
  271.   -p  Pause after loading        [note that this is lowercase 'p']
  272.       Causes Lharc to wait for the user to press RETURN before
  273.       executing a command. This allows floppy disk users to swap disks
  274.       after loading Lharc.
  275.  
  276.   -m  no Message for query
  277.       Suppresses all the queries Lharc normally issues before
  278.       overwriting existing files or before creating new directories
  279.       If you specify this switch Lharc will behave as if you choose
  280.       the default action (indicated by an uppercase letter) in
  281.       response to all the questions. This switch also disables
  282.       autoshowing of files (see 'Autoshow files' below)
  283.  
  284.   -x  use eXtended file names
  285.       By default, LHarc stores only the file names of
  286.       files and disregards the names of the directories in which
  287.       they reside.  This switch, used with the 'a' command, tells LHarc
  288.       to extend all file names with directory names; with the 'x' 'e' 'd'
  289.       and 'v' commands the -x switch is automatically turned on: use
  290.       -x0 if you want to turn it off thus ignoring pathnames with these
  291.       commands.
  292.  
  293.   -n  No progress indicator
  294.       Suppresses the display of the number of bytes beeing processed
  295.       during compression or decompression. May be useful if you
  296.       redirect to a file the output of Lharc.
  297.       Note: this version of Lharc allows the -N switch as a synonim of -n :
  298.       but this might change in future versions, so preferibly use the
  299.       lowercase letter.
  300.  
  301.   -w  set Work directory
  302.       Use this switch to choose your own directory for temporary files.
  303.       The directory name must immediatly follow the letter 'w' without
  304.       any leading space, i.e. to set the 'temp' directory on your
  305.       hard-disk as the working directory you must write "-wdh0:temp".
  306.       See below "Temporary files" for a discussion on where temporary
  307.       files are stored in the absence of this switch.
  308.  
  309.   -P  set Priority          [note that this is uppercase 'P']
  310.       Use this switch to set the priority with which Lharc will be
  311.       executed. Priority must be in the range -5..+5  and must
  312.       immediately follow the 'P' letter without blanks in between.
  313.       By default Lharc is excuted with the same priority of
  314.       the task that invoked it; using this switch will set the new
  315.       priority immediatley after loading and will set back the priority
  316.       to the original value immediately after terminating.
  317.       If you want to do something else with your Amiga, for example
  318.       editing a letter, while Lharc is compressing a long file, I
  319.       suggest that you set Lharc's priority to one less than that of
  320.       the other program, i.e. if you started your editor with the usual
  321.       priority of zero then invoke Lharc with the '-P-1' switch to set its
  322.       priority to -1
  323.  
  324.   -a  consider file Attributes
  325.       By default Lharc will ignore file attributes (i.e. the flags
  326.       indicating protection from deletion, and so on) for maximum
  327.       compatibility with the MSDOS version: in other words it will
  328.       store files with an attribute bit pattern which is suitable for
  329.       MSDOS machines while during extraction it will ignore the
  330.       attributes stored in the archives, setting the attributes of the
  331.       extracted files to the usual '----rwed'.
  332.       If you use this switch, on the contrary, files will be stored
  333.       with their original attributes and during extraction the
  334.       stored attributed will be restored.
  335.       Remember that, to effectively preserve file attributes, you must
  336.       use this switch both during compression and during extraction.
  337.       Of course AmigaDOS file attributes are meaningless to MSDOS and
  338.       vice-versa; so extract files with the -a switch only if you are
  339.       sure that they contain AmigaDOS file attributes and similarly
  340.       compress files with the -a switch only if you are sure that the
  341.       archive will be unpacked only by Amigas and not by MSDOS
  342.       machines. (Anyway no harm is done if this rule is not respected:
  343.       extracted files will simply have strange attributes)
  344.  
  345.   -u  convert file names to Uppercase
  346.       By default Lharc stores file names/paths with thier original case,
  347.       if you use this switch they will be converted to uppercase.
  348.       See below 'Compatibility' for a possible use of this switch.
  349.  
  350.   -r  Recursively collect files
  351.       This switch instructs Lharc to search for files matching the
  352.       specified patterns not only in the specified directories, but also
  353.       in all the subdirectories that may be found in the specified
  354.       directories. For example: "Lharc -r a archive.lzh df1:source/*.c"
  355.       will search for files whose name ends with ".c" in "df1:source/"
  356.       and in all the subdirectories that may be contained in the
  357.       "df1:source" directory.
  358.       Another example: "Lharc -r a archive.lzh df1:*" will archive the
  359.       entire disk in drive df1:, including all its subdirectories.
  360.       (you may wish to add the -a switch to the above line in order to
  361.       be able to re-build exactly the disk, including file attributes)
  362.       Very powerfull, isn't it ?
  363.       When you specify the -r switch, files are always stored with their
  364.       path name, i.e. the -r switch automatically turns on the -x switch,
  365.       too.
  366.  
  367.   -S  Set sorting criteria          [note that this is an UPPLERCASE S]
  368.       This switch sets the sort criterium for files beeing added to
  369.       archives. The '-S' must be immediatly followed by one or two
  370.       characters, i.e. -Sxy
  371.       'x' can be any of the following:
  372.          0  Don't sort files
  373.          a  Alphabetical sort
  374.          c  Chronological sort
  375.       'y', if present, can be any of the following:
  376.          a  Ascending order
  377.          d  Descending order
  378.       If 'y' is absent, ascending order is assumed by default.
  379.       Examples:
  380.          -Scd          Sort chronologically in descending order
  381.          -Sc  or -Sca  Sort chronologically in ascending order.
  382.          -S0           Don't sort at all
  383.          -Saa          Sort alphabetically in ascending order, this is
  384.                        the default action which is taken if you don't
  385.                        specify this switch.
  386.  
  387.   -b  Set I/O buffer size
  388.       Big I/O buffers can considerably speed up some operations of Lharc
  389.       (espacially with hard disks) however if you are low on memory you
  390.       may prefer to use small I/O buffers.
  391.       This switch lets you set the amount of memory that Lharc will use
  392.       as an I/O buffer: the number of Kbytes of memory to be used must
  393.       immediately follow the 'b' without any spaces in between, e.g.
  394.       -b20 tells Lharc to use 20 kbytes of memory for I/O buffers.
  395.       Any number between 6 and 37 is valid, default is using 11 Kbytes:
  396.       if you are low on memory you can lower this amount, but if you have
  397.       plenty of memory I suggest that you rise it.
  398.       I suggest that you set this switch at the value you like in the
  399.       environment variable 'LHARC' (see below) so that you don't have
  400.       to specify this switch every time you invoke Lharc.
  401.  
  402.   -f  Ignore filenotes
  403.       By defaults Lharc archives files complete with their comment
  404.       (filenote). If you set this switch filenotes won't be stored in
  405.       archives and files beeing extracted won't have their filenote
  406.       even if it's present in the archive.
  407.       There is no compatibility problem, but if you are not interested
  408.       in filenotes you may set this switch to reduce the archive size
  409.       (filenotes are stored in uncompressed form, so if you have long
  410.       filenotes they can increase the size of the archive)
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  --- Setting switches in an environment variable ---
  419.  
  420.    You may set any of LHarc's default switches with the environment
  421.    variable 'LHARC':
  422.    So, if you, for example, want to always archive files with their
  423.    attributes, use the maximum allowed I/O buffer size and use
  424.    'dh0:mytemp/' as a working directory you simply type:
  425.  
  426.    SenEnv LHARC  "-wdh0:mytemp -a -b37"
  427.  
  428.    (don't forget the quotes): now Lharc will behave as if you typed
  429.    the above switches every time you invoke it. You can insert the
  430.    setenv command in your startup-sequence so that it's automatically
  431.    executed every time you turn your computer on.
  432.    Of course, you can always override the default settings
  433.    estabilisced in the enviroment variable with the command line: for
  434.    example an '-a0' in the command line will override the '-a' found
  435.    in the above enviromnet variable.
  436.    Please note that the 'setenv' command is only available in
  437.    Workbench 1.3 and higher: if you are using older versions of the
  438.    O.S. this feature is not available.
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  --- Autoshow files ---
  447.  
  448. Suppose that your archive contains an important text file that you
  449. want to be sure it will be read by the guy who unpacks the archive.
  450. The file may for example contain a copyright notice or some special
  451. instructions for unpacking (if you have packed the archive with the -a
  452. switch you may wish to remind to the one who unpacks the archive the
  453. he/she has to use the -a switch too).
  454. For this purpuse this version of Lharc introduces autoshow files: while
  455. unpacking an archive, if Lharc encounters a file whose name ends with
  456. ".TXT.DISPLAYME" (case is not significant and quotes must not be
  457. included, of course), it first extracts the file (removing the .DISPLAYME
  458. extension) and then displays in a window the text found in that file
  459. waiting for the user to press RETURN before proceeding.
  460. You can add as many autoshow files as you want, for example one at the
  461. beginning and one at the end of the archive.
  462. Autoshowing of files is disabled when the -m switch is active so that
  463. a non-interactive unpacking session is allowed.
  464. Lharc uses the standard CON: device to open a window for displaing text,
  465. so you can insert ANSI codes in your autoshow files to make your
  466. messages nicer. Lharc will adjust the size of the window according to
  467. the number of lines contained in the text file, but the maximum allowed
  468. size is that of an NTSC screen (200 pixels), so if your text is longer
  469. than 20 lines it will scroll away.
  470. Finally, please note that this feature is unique to the Amiga version of
  471. Lharc (for now...) so remember that if your archive will be unpacked on
  472. another machine (or an an Amiga using Lharc version 1.0 or lower)
  473. autoshow files will simply be extracted without displaying them on the
  474. screen; anyway your important text file will still be there for later
  475. reading by the user and no compatibility problems will arise.
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  --- Temporary files ---
  485.  
  486. While compressing files Lharc creates a temporary file called
  487. 'Lharc.TMP_XXXXXX' where XXXXXX is a hex digit representing the address
  488. of its own Task structure as returned by Exec's FindTask(NULL).
  489. The reason for the XXXXXX part of the name is that if you run multiple
  490. copies of Lharc at the same time each copy will create its own temporary
  491. file with a different name (usefull for multiline BBSes for example).
  492. Here is how Lharc decides where to store temporary files.
  493. If you specify a path with the -w switch temporary files are stored
  494. there, otherwise if the T:  logical device is assigned they will be
  495. stored in that directory, otherwise they will go to the current
  496. directory.
  497. If you are not using the -w switch, in order to increase compression
  498. speed, I raccomand that you assign T:  to a directory in the ram-disk.
  499. Note however that T:  is usually automatically assigned to 'ram:t' in
  500. the startup-sequence of the standard Workbench, so, unless you have
  501. modified the startup-sequence, you don't have to worry about this.
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  --- Corrupted archives ---
  514.  
  515. This version al Lharc for the Amiga has the capability of automatically
  516. handle corrupted archives.
  517. A Lharc archive is made up of several compressed files each precedeed by
  518. a header containing information about file name, date, lenght,...
  519. To ensure that the archive is not corrupted the header also contains a
  520. 16 bit CRC of the file and an 8 bit checksum of the header itself.
  521. If during extraction Lharc finds a corrupted file (i.e. one whose CRC
  522. does not match with the one stored in the header) the file is extracted
  523. anyway, but a warning is printed on the screen.
  524. The worst case comes when the header of a file is corrupted: in this case
  525. the file cannot be extracted even if the file itself is not corrupted.
  526. In this case Lharc will automatically skip the corrupted entry by
  527. starting a search for the next valid entry in the archive and will
  528. print a message like "WARNING: skipping extraneous/corrupted data"
  529. The reason for which it says "extraneous/corrupted" is that an Lharc
  530. archive might happen to contain parts that Lharc cannot recognize as valid
  531. archive entries even it's not corrupted. This happens when you are
  532. extracting files from a self-extracting archive produced by the MSDOS
  533. version of Lharc, since a self-extracting archive contains 8086
  534. extraction code which the Amiga-Lharc sees as extraneous data.
  535. The only extraneous data which is passed without warnings is additional
  536. bytes at the end of an archive: since they are likely to consist of
  537. zero padding due to XMODEM transfer they are totally ignored.
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  --- Return codes ---
  548.  
  549. When Lharc finishes his work, it returns to the operating system one of
  550. 3 possible return codes:
  551.  
  552.  0  Everything was OK  (the message "Operation successful" is printed on
  553.     the screen).
  554.  5  Lharc finished its work, but something went wrong, for example Lharc
  555.     encountred a corrupted entry in the archive, but was able to continue
  556.     extracting/testing the rest of the archive (the message "Operation not
  557.     totally succesful" is printed on the screen).
  558.  20 A fatal error occurred and Lharc was unable to continue its work (an
  559.     appropriate message exlpaining the probelm is printed on the sceen)
  560.  
  561. Thus you can test the succes of operation in your script files by means
  562. of the 'failat' statement and the 'if warn' test.
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  --- Bugs ---
  572.  
  573. No known known bugs remain in this version.
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  ---- Compatibility ---
  583.  
  584. This program is aimed at full compatibility with the MSDOS version
  585. 1.13 of Lharc.
  586. A few little problems might arise from some file names that are legal
  587. under AmigaDOS, but illegal under MSDOS. As a matter of facts AmigaDOS
  588. allows a wider range of file names (almost every caracter in the ASCII
  589. set is allowed and file names can be longer than 8 characters). For
  590. the greatest convenience of Amiga users, I choose not to restrict the
  591. file name range to accomplish the MSDOS rules, but if you expect that
  592. your archives will be unpacked on an MSDOS machine you'd better
  593. rispect the MSDOS limits.
  594. Also note that, although MSODS Lharc version 1.13 CAN extract files
  595. whose names contain lowercase letters, its pattern matching functions
  596. don't work properly with lowercase file names. So if you want to
  597. extract an Amiga-created archive on an MSDOS machine by using pattern
  598. matching functions (for example to extract only some files instead of
  599. the whole archive) you have to create the archive on the Amiga with
  600. the -u switch.
  601. Finally, to attain 100% compatibility you shuold not use the '-a' switch
  602. (see above in the switch descriptions)
  603.  
  604. Also note that the MSDOS version of Lharc has the additional
  605. capability of extracting files from archives produced by Larc (a
  606. pupular Japanise archive program): this feature will not be
  607. implemented in the Amiga version.
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  ---- Acknowledgements ---
  618.  
  619. First of all I give credit to Haruyasu Yoshizaki for devising such an
  620. efficent compression algorythm as LZHUF.
  621. Second, since the source to the MSDOS version of Lharc is scarcely
  622. portable (lots of 8086 assembler ruotines and MSDOS-dependent C
  623. functions), I had to rewrite the program from scratch. Note however
  624. that for LZHUF compression/decompression I have used as a starting
  625. point a 'C' source for an example of single file compression
  626. which I found on a BBS. Although the code has been now remanaged (and
  627. partially rewritten in assembler by Paolo Toccaceli) it nevertheless
  628. was invaluable to me.
  629. For sake of correctness I quote here the the header found on this
  630. source:
  631.  
  632. /*
  633.  * LZHUF.C English version 1.0
  634.  * Based on Japanese version 29-NOV-1988
  635.  * LZSS coded by Haruhiko OKUMURA
  636.  * Adaptive Huffman Coding coded by Haruyasu YOSHIZAKI
  637.  * Edited and translated to English by Kenji RIKITAKE
  638.  */
  639.  
  640. I whish to thank the above people whose work has been of
  641. foundamental importance for this project.
  642. Thanks to Stefan Boberg for suggesting how to store filenotes in the
  643. archive structure that didn't provide space for them.
  644. Many thanks also go to all the people who contributed with suggestions
  645. and bug reports and particularly to Luca Spada for his invaluable beta
  646. testing work.
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  --- How to reach me ---
  657.  
  658. Please send suggestions, comments and bug reports to:
  659.  
  660. Paolo Zibetti       Fidonet 2:331/101.6
  661.  
  662. node 2:331/101 (AmnesiA) is also the official distribution node for
  663. Amiga-Lharc: you'll always find the latest version available on this
  664. board. If you are an officially listed FidoNet node you can f'request
  665. the latest version of Lharc with the magic file name AMILHARC.
  666.  
  667. Amnesia (2:331/101)  phone +39-331-263425  (v32/HST, upto 14400 bps)
  668.  
  669.  
  670.  
  671. For those who don't have access to a FidoNet node, my Fidonet point
  672. can also be reached from Internet/UUCP at the following address:
  673.  
  674. Paolo.Zibetti@p6.f101.n331.z2.fidonet.org
  675.  
  676.  
  677.